DisplayFrameAdded

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

DisplayFrameAdded
The DisplayFrameAdded method should add the specified frame to this part's internal list of display frames.
void DisplayFrameAdded (in ODFrame frame);
frame
A reference to a display frame to be added.

DISCUSSION
OpenDoc calls this method only when a new display frame has been added to this part during frame object initialization.
Your part's DisplayFrameAdded method should perform any actions necessary to handle the addition of the specified frame to your part's internal list of display frames. Some actions depend on the nature and implementation of the part itself, but others are standard, such as adding the new frame to your part's internal list of display frames, verifying that you can support the frame's view type and presentation, and adding any needed part info data to the frame.
Your part should not perform any layout or imaging tasks as a result of a display frame being added; it should wait until your part's FacetAdded method is called, at which time the frame becomes visible.
Your part's DisplayFrameAdded method is typically called after OpenDoc or this part's containing part calls a draft's CreateFrame method. By contrast, a part's DisplayFrameConnected method is called after OpenDoc or this part's containing part calls a draft's GetFrame method.

OVERRIDING
When you subclass ODPart, you must override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely.

SEE ALSO
The ODPart::DisplayFrameConnected method (page 496).
"The DisplayFrameAdded Method" on page 53 in OpenDoc Cookbook.
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"Responding to an Added Display Frame" on page 110 in OpenDoc Programmer's Guide.
"Null Events" on page 194 in OpenDoc Programmer's Guide.